Release 10.1A: OpenEdge Development:
Progress Dynamics Advanced Development


General-purpose methods

The following additional methods are useful programming aids that do not fall into any other particular category.

modifyListProperty

This internal procedure allows you to add or delete values from any object property that is a comma-separated list. There are a number of such properties, such as DisplayedFields and EnabledFields, described in this chapter, and their values might need to be changed programmatically at run time. This procedure simplifies the job of adding or removing a string from within the list, as shown:

Procedure modifyListProperty: 
  Params: INPUT phCaller AS HANDLE – handle of the object whose property is 
being  
                  changed 
          INPUT pcMode AS CHARACTER -- 'ADD' or 'REMOVE' 
          INPUT pcListName AS CHARACTER -- name of the property 
          INPUT pcListvalue AS CHARACTER -- the value to add or remove 
  Candidate for: calling 

signature

This CHARACTER function returns the signature, or calling sequence, of the named function or internal procedure in the format returned by the Progress GET-SIGNATURE method. Because the entry point you need to access might in fact be implemented in a super procedure of the object where you actually run it, this function saves you from having to search through the super procedure stack to locate it, as shown:

Function Signature: 
  Params:  INPUT pcName AS CHARACTER -- function or procedure name. 
  Returns: CHARACTER: signature in Progress GET-SIGNATURE format. 
Candidate for: calling 


Copyright © 2005 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095